Skip to content

Add a section to the intro on getting help#1100

Merged
ineelhere merged 2 commits intoswcarpentry:mainfrom
tobyhodges:llm-assistants
May 7, 2025
Merged

Add a section to the intro on getting help#1100
ineelhere merged 2 commits intoswcarpentry:mainfrom
tobyhodges:llm-assistants

Conversation

@tobyhodges
Copy link
Copy Markdown
Member

This adds a new section to the first episode about how to get help with writing & debugging Python, including a discussion of generative AI in this context. It is based on the changes made and discussed in swcarpentry/python-novice-gapminder#697 (and in various other communication channels -- please see the linked PR thread for more details)

This moves the first mention of the built-in help function earlier in the lesson (it was previously in episode 8), and briefly discusses some things that are then covered in more depth in the Debugging episode.
This might feel redundant but IMO it is sensible to discuss strategies for getting help early in the lesson. Furthermore, the guidance added here about how (not) to use LLM assistants while learning to code needs to appear early on.

This adds a large block of (seemingly) new content. However, most Instructors are presumably spending time covering these points in workshops already. The changes formalise that in the lesson, making it more useful for self-directed learners following it outside a workshop setting.

@github-actions
Copy link
Copy Markdown

github-actions Bot commented May 7, 2025

Thank you!

Thank you for your pull request 😃

🤖 This automated message can help you check the rendered files in your submission for clarity. If you have any questions, please feel free to open an issue in {sandpaper}.

If you have files that automatically render output (e.g. R Markdown), then you should check for the following:

  • 🎯 correct output
  • 🖼️ correct figures
  • ❓ new warnings
  • ‼️ new errors

Rendered Changes

🔍 Inspect the changes: https://github.com/swcarpentry/python-novice-inflammation/compare/md-outputs..md-outputs-PR-1100

The following changes were observed in the rendered markdown documents:

 01-intro.md     | 88 +++++++++++++++++++++++++++++++++++++++++++++++++++++++++
 08-func.md      |  1 -
 11-debugging.md |  2 +-
 md5sum.txt      |  6 ++--
 4 files changed, 92 insertions(+), 5 deletions(-)
What does this mean?

If you have source files that require output and figures to be generated (e.g. R Markdown), then it is important to make sure the generated figures and output are reproducible.

This output provides a way for you to inspect the output in a diff-friendly manner so that it's easy to see the changes that occur due to new software versions or randomisation.

⏱️ Updated at 2025-05-07 13:17:17 +0000

github-actions Bot pushed a commit that referenced this pull request May 7, 2025
@ineelhere ineelhere merged commit bb3690c into swcarpentry:main May 7, 2025
3 checks passed
github-actions Bot pushed a commit that referenced this pull request May 7, 2025
Auto-generated via `{sandpaper}`
Source  : bb3690c
Branch  : main
Author  : Indraneel Chakraborty <64887729+ineelhere@users.noreply.github.com>
Time    : 2025-05-07 15:40:04 +0000
Message : Merge pull request #1100 from tobyhodges/llm-assistants

Add a section to the intro on getting help
github-actions Bot pushed a commit that referenced this pull request May 7, 2025
Auto-generated via `{sandpaper}`
Source  : 696d478
Branch  : md-outputs
Author  : GitHub Actions <actions@github.com>
Time    : 2025-05-07 15:40:46 +0000
Message : markdown source builds

Auto-generated via `{sandpaper}`
Source  : bb3690c
Branch  : main
Author  : Indraneel Chakraborty <64887729+ineelhere@users.noreply.github.com>
Time    : 2025-05-07 15:40:04 +0000
Message : Merge pull request #1100 from tobyhodges/llm-assistants

Add a section to the intro on getting help
github-actions Bot pushed a commit that referenced this pull request May 13, 2025
Auto-generated via `{sandpaper}`
Source  : 696d478
Branch  : md-outputs
Author  : GitHub Actions <actions@github.com>
Time    : 2025-05-07 15:40:46 +0000
Message : markdown source builds

Auto-generated via `{sandpaper}`
Source  : bb3690c
Branch  : main
Author  : Indraneel Chakraborty <64887729+ineelhere@users.noreply.github.com>
Time    : 2025-05-07 15:40:04 +0000
Message : Merge pull request #1100 from tobyhodges/llm-assistants

Add a section to the intro on getting help
github-actions Bot pushed a commit that referenced this pull request May 13, 2025
Auto-generated via `{sandpaper}`
Source  : 696d478
Branch  : md-outputs
Author  : GitHub Actions <actions@github.com>
Time    : 2025-05-07 15:40:46 +0000
Message : markdown source builds

Auto-generated via `{sandpaper}`
Source  : bb3690c
Branch  : main
Author  : Indraneel Chakraborty <64887729+ineelhere@users.noreply.github.com>
Time    : 2025-05-07 15:40:04 +0000
Message : Merge pull request #1100 from tobyhodges/llm-assistants

Add a section to the intro on getting help
github-actions Bot pushed a commit that referenced this pull request May 20, 2025
Auto-generated via `{sandpaper}`
Source  : 696d478
Branch  : md-outputs
Author  : GitHub Actions <actions@github.com>
Time    : 2025-05-07 15:40:46 +0000
Message : markdown source builds

Auto-generated via `{sandpaper}`
Source  : bb3690c
Branch  : main
Author  : Indraneel Chakraborty <64887729+ineelhere@users.noreply.github.com>
Time    : 2025-05-07 15:40:04 +0000
Message : Merge pull request #1100 from tobyhodges/llm-assistants

Add a section to the intro on getting help
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants